home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / src / Tools / mpeg_encode-1.5 / README < prev    next >
Text File  |  1995-07-13  |  6KB  |  130 lines
  1.  
  2.                  MPEG-1 Video Software Encoder
  3.                 (Version 1.5; February 1, 1995)
  4.  
  5.      Lawrence A. Rowe, Kevin Gong, Eugene Hung, Ketan Patel, Steve Smoot
  6.        and Dan Wallach
  7.     Computer Science Division-EECS, Univ. of Calif. at Berkeley
  8.  
  9. This directory contains the freely distributed Berkeley MPEG-1 Video 
  10. Encoder.  The encoder implements the standard described in the ISO/IEC
  11. International Standard 11172-2.  The code has been compiled and tested 
  12. on the following platforms:
  13.  
  14.  DECstation 5000 and Alpha
  15.  HP PA-RISC (HP/UX 9.X) (i.e., HP 9000/7XX and 9000/3XX)
  16.  SGI Indigo running IRIX 5.0.1
  17.  Sun Sparc (SunOS 4.X)
  18.  
  19. In addition, Rainer Menes from the Technical University of Munich has
  20. ported the encoder and decoder to the Macintosh.  You can get that code
  21. directly from him (menes@statistik.tu-muenchen.de), or from the 
  22. Berkeley FTP archive (mm-ftp.CS.Berkeley.EDU).  If you decide to port 
  23. the code to a new architecture, please let us know so that we can 
  24. incorporate the changes into our sources.
  25.  
  26. This directory contains everything required to build the encoder
  27. and run it.  We have included source code, makefiles, binaries
  28. for selected platforms, documentation, and test data.  Installation 
  29. instructions are given in the file named src/mpeg_encode/INSTALL.  A man 
  30. page is given in the file doc/mpeg_encode.1.  A detailed user 
  31. manual is provided in postscript format in the file doc/user-manual.ps.
  32.  
  33. The encoder will accept any input file format as long as you provide 
  34. a script to convert the images to PPM, YUV, JPEG, or JMOVIE format.  Input 
  35. file processing is described in the file doc/INPUT.FORMAT.  Options to 
  36. control input file processing and compression parameters are specified in 
  37. a parameter file.  Very little error processing is done when reading 
  38. this file.  We suggest you start with the sample parameter file 
  39. examples/template.param and modify it.  See also examples/default.param.
  40.  
  41. The convert directory of Mpeg-Tools contains utilities you might find 
  42. useful including: 
  43.  
  44. programs to do PPM/YUV conversion and programs to convert Parallax
  45. XVideo JPEG files into PPM, YUV, or JPEG frames.
  46.  
  47. The motion vector search window can be specified, including half-pixel
  48. block matching, in the parameter file.  We have implemented several 
  49. search algorithms for P-frames including: 1) exhaustive search, 
  50. 2) subsampled search, and 3) logarithmic search.  We have also implemented
  51. several alternatives for B-frame block matching including: 1) interpolate
  52. best forward and best backward block, 2) find backward block for best
  53. forward or vice-versa (called CROSS2), and 3) exhaustive cross product
  54. (i.e., go out for coffee and a donut!). The search algorithms are controlled
  55. by options in the parameters file.  For tips on choosing the right search
  56. technique, see the user manual.
  57.  
  58. The encoder can be run on one computer (i.e., sequential) or on several
  59. computers (i.e., parallel).  Our goal is to produce a portable, easy-to-use
  60. encoder that we can use to encode large volumes of video material for
  61. the Berkeley VOD system (see paper VodsProp93.ps.Z on the FTP archive).
  62. The parallelism is done on a sequence of pictures.  In other words, you 
  63. can spawn one or more children to encode continuous runs pictures. The 
  64. uncompressed data can be accessed either through NFS or TCP sockets.  
  65. The goal is to allow you to encode using multiple processors, think 
  66. spare cycles on workstations, to speed up the encoding time.  Although
  67. performance depends on the speed of individual processors, the file system
  68. and network, and the P/B frame search methods, we have encoded 3.75
  69. frames/second on 8 HP Snakes running in parallel as compared with 0.6
  70. frames/second on 1 Snake.  These are preliminary results. We are continuing 
  71. to experiment with and tune the code.  Instructions to run the parallel system 
  72. are given in the man page and the parallel.param example parameter file.
  73.  
  74. We have done some tuning to produce a reasonable encoder, but there are
  75. many more optimizations that we would like to incorporate.  These 
  76. extensions are listed in the file doc/EXTENSIONS.  If you succeed in 
  77. implementing any of them, please let us know! 
  78.  
  79. Send bug reports to:
  80.  
  81. mpeg-bugs@CS.Berkeley.EDU
  82.    Problems, questions, or patches should be sent to this address.
  83.  
  84. Anyone interested in providing financial support for this research or 
  85. discussing other aspects of this project should contact Larry Rowe at 
  86. Rowe@CS.Berkeley.EDU (+1 510-642-5117).
  87.  
  88. This software is freely distributed.  That means, you may use it for 
  89. any non-commercial purpose.  However, patents are held by several companies 
  90. on various aspects of the MPEG video standard.  Companies or individuals
  91. who want to develop commercial products that include this code must
  92. acquire licenses from these companies.  For information on licensing, see
  93. Appendix F in the standard.
  94.  
  95. ACKNOWLEDGEMENTS:
  96.  
  97. We gratefully thank Hewlett-Packard and Fujitsu who provided financial
  98. support for this work.  We also want to thank the following people and
  99. organizations for their help:
  100.  
  101.     Jef Poskanzer who developed the pbmplus package.
  102.     ---------
  103.     Copyright (C) 1989, 1991 by Jef Poskanzer.
  104.  
  105.     Permission to use, copy, modify, and distribute this software and its
  106.     documentation for any purpose and without fee is hereby granted, provided
  107.     that the above copyright notice appear in all copies and that both that
  108.     copyright notice and this permission notice appear in supporting
  109.     documentation.  This software is provided "as is" without express or
  110.     implied warranty.
  111.     ---------
  112.  
  113.     Eiichi Kowashi of Intel and Avideh Zakhor of U.C. Berkeley who
  114.     provided valuable suggestions on motion vector searching.
  115.  
  116.     Chad Fogg of the University of Washington who has helped us 
  117.     understand many issues in MPEG coding and decoding.
  118.  
  119.     Rainer Menes of the Technical University of Munich who has ported the
  120.     the Berkeley MPEG encoder and decoder to the Macintosh, and he has 
  121.     provided us with many suggestions to improve the code.
  122.  
  123.     Robert Safranek of ATT for comments, suggestions, and most of the
  124.     code for custom quantization tables.
  125.  
  126.     Jim Boucher of Boston University for jmovie2jpeg.
  127.  
  128.     The San Diego SuperComputing Center for providing facilities to 
  129.     develop some of the code contained within.
  130.